home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / olrdrs / qwkndt1a.zip / QWKNDTY.DOC < prev    next >
Text File  |  1992-11-06  |  16KB  |  391 lines
  1.                        Documentation for QWK'n'Dirty 1.1a
  2.                              Copyright 1992 by
  3.                              Anthony W. Hursh
  4.  
  5.  
  6.                              LIMITED WARRANTY
  7.  
  8.  
  9.         THIS SOFTWARE IS PROVIDED "AS-IS", WITHOUT WARRANTY OF ANY KIND.
  10. THERE ARE NO EXPRESS OR IMPLIED WARRANTIES. THERE ARE NO WARRANTIES OF
  11. OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  12.  
  13.  
  14.         THE COPYRIGHT HOLDER SHALL NOT IN ANY CASE BE LIABLE FOR SPECIAL,
  15. INCIDENTAL, CONSEQUENTIAL, INDIRECT OR OTHER SIMILAR DAMAGES ARISING FROM
  16. THE USE OF, OR THE INABILITY TO USE, THE SOFTWARE, EVEN IF THE COPYRIGHT
  17. HOLDER OR HIS AGENT HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  18.  
  19.  
  20.  
  21.  
  22.         QWK'n'Dirty is a combination offline reader and terminal program
  23. for QWK compatible bulletin board systems. QWK'n'Dirty is a shareware
  24. program. If you wish to continue using QWK'n'Dirty after an evaluation
  25. period of two weeks you must register your copy. Send $25.00 in U.S.
  26. funds to:
  27.  
  28.         Anthony W. Hursh
  29.         P.O. Box 141293
  30.         Anchorage, AK 99514
  31.  
  32. You'll receive a registration code by return mail. This code, when entered
  33. into the REGISTER.EXE program that comes with the QWK'n'Dirty package,
  34. registers your copy of QWKNDTY.EXE and removes the annoying "unregistered
  35. shareware" line from the posted messages. You'll also receive a
  36. distribution code that lets you earn money by distributing QWK'n'Dirty.
  37. See MAKECASH.DOC for further details.
  38.  
  39.  
  40.                     GENERAL INFORMATION ON QWK READERS
  41.  
  42.  
  43.         A QWK reader allows you to download messages from a bulletin
  44. board system and read them on your own PC. This saves time (= money,
  45. if you're calling long distance) for both you and the BBS. In addition,
  46. you can use your own personal text editor to write your messages.
  47. A QWK compatible BBS generates .QWK files. You download these files,
  48. read them with the QWK reader, and write replies. Your replies are
  49. put into a .REP file that you upload to the BBS. With most QWK readers
  50. you must use a separate terminal program to call the BBS and up/download
  51. your messages. Not so with QWK'n'Dirty. It is a terminal program and
  52. a QWK reader, all in one.
  53.  
  54.  
  55.                            PREINSTALLATION NOTES
  56.  
  57.  
  58.         Before installing QWK'n'Dirty, you must have a couple of programs
  59. that aren't included with the distribution:
  60.  
  61. 1. DSZ.COM or DSZ.EXE from Omen Technology. This program is used to
  62. download .QWK packets and upload .REP packets, using Xmodem,
  63. Ymodem, or Zmodem.
  64.  
  65. 2. PKZIP/PKUNZIP from PKWare, LHA by "Yoshi", and/or ARJ by
  66. Robert K. Jung. These programs are used to compress and uncompress
  67. your .QWK and .REP packets. QWK'n'Dirty supports ARJ, LZH and ZIP
  68. compression. Which one you need to use depends on the BBS you're
  69. calling. Most boards seem to prefer ZIP, but there are some out
  70. there which use ARJ, and some which allow you a choice. Check with
  71. your sysop if you can't figure out which to use. If you call several
  72. boards, you may need two or more of these.
  73.  
  74.         These programs must be in the QWK'n'Dirty directory or another
  75. directory on your PATH in order for QWK'n'Dirty to find them.
  76.  
  77.  
  78.  
  79.                         SETTING UP QWK'N'DIRTY
  80.  
  81.  
  82. Make a new directory and put all the QWK'n'Dirty files in it.
  83. QWK'n'Dirty automatically creates any subdirectories it needs under
  84. this main QWK'n'Dirty directory. If you wish to run QWK'n'Dirty from
  85. other directories, you can put the QWK'n'Dirty directory on your PATH.
  86. You must also set a QWK'n'Dirty environment variable to run QWK'n'Dirty
  87. from other directories. Otherwise the program will not be able to find
  88. the files that it needs. Do this by putting the line:
  89.  
  90. SET QWKNDTY=C:\SOME\DIR\
  91.  
  92. in your AUTOEXEC.BAT file, where C:\SOME\DIR is your QWK'n'Dirty
  93. directory. Then reboot.
  94.  
  95. If you'll always be running QWK'n'Dirty from the QWK'n'Dirty directory
  96. you don't need to set your PATH or the environment variable.
  97.  
  98. QWK'n'Dirty requires a FOSSIL driver. A FOSSIL is a special program
  99. that takes control of your communications port and makes it easy for
  100. applications programs to use it. OpusComm, a public domain FOSSIL driver,
  101. is included with the QWK'n'Dirty distribution. There are several other
  102. shareware/freeware FOSSIL drivers available, including X00 and BNU.
  103.  
  104. The supplied OPQWK.BAT file loads the included OpusComm FOSSIL driver
  105. before running QWK'n'Dirty, and unloads it after exiting. BNUQWK.BAT
  106. loads and unloads BNU (BNU is not supplied with this distribution).
  107.  
  108. I've had poor luck getting X00 to work with QWK'n'Dirty (or any other
  109. program, for that matter). It locks up my machine and leaves the serial
  110. port in such a state that Ctrl-Alt-Del will not restore it to proper
  111. functioning (the computer will reboot but the serial port is toasted.
  112. Only a complete power down will restore normal operation). This may
  113. be due to some peculiarity of my serial card. If X00 works for you
  114. with other applications, it may work with QWK'n'Dirty. Give it a try.
  115.  
  116. If you already have a FOSSIL driver installed (for example, to run a BBS)
  117. simply execute QWK'n'Dirty by running QWKNDTY.EXE directly instead
  118. of using OPQWK.BAT or BNUQWK.BAT.
  119.  
  120. The default FOSSIL setup should work fine for most machines. If you
  121. have special needs, and you're using OpusComm, check the documentation in
  122. OCOM_531.ZIP for more information. In particular, you may need to increase
  123. the FOSSIL buffer size if you have a high-speed modem (or a slow computer).
  124. One symptom of this is dropped characters. If you're using another FOSSIL
  125. driver, such as BNU or X00, check the appropriate documentation.
  126.  
  127. Now, edit the QWEDIT.BAT file. QWEDIT.BAT is used to edit your replies.
  128. The file name to edit is passed to the batch file as %1. The QWEDIT.BAT
  129. file goes in the same directory as your QWK'n'Dirty program. The supplied
  130. QWEDIT.BAT file is set up for use with QEdit, a popular shareware text
  131. editor. You could easily change QWEDIT.BAT to use any other text editor,
  132. even the pre-DOS 5.0 EDLIN (gag!). To do this, you'd put:
  133.  
  134. EDLIN %1
  135.  
  136. in the RUNQWK.BAT file.  The DOS 5.0 EDIT program (*much* better) could be
  137. used by putting the line:
  138.  
  139. EDIT %1
  140.  
  141. in the RUNQWK.BAT file. You can use any text editor that allows you
  142. to specify the file name on the command line, and allows you to save
  143. ASCII files. You could even use a word processing program such as
  144. WordPerfect (talk about overkill :-) if the program lets you
  145. save the file in ASCII format (WordPerfect calls an ASCII file a
  146. "DOS Text File"). Make *sure* that your editor uses ASCII, or
  147. Really Ugly Things will happen.
  148.  
  149. QWK'n'Dirty has no internal editor. In my experience, the internal
  150. editors supplied with QWK readers are slow, clumsy, confusing, and
  151. increase the program size dramatically. It's much better to use your
  152. own editor.
  153.  
  154.  
  155.  
  156.  
  157.                                USING QWK'n'Dirty
  158.  
  159.  
  160. Run the program by typing one of the following:
  161.  
  162. OPQWK (if you're using OpusComm)
  163. BNUQWK (if you're using BNU)
  164. QWKNDTY (if you already have a FOSSIL installed).
  165.  
  166. After the FOSSIL driver loads you'll see a title screen and shareware
  167. notice. Hit any key.
  168.  
  169. The first time you start up QWK'n'Dirty you'll go through the configuration
  170. process. This is where you tell QWN'n'Dirty what com port to use, the
  171. default baud rate, your modem initialization string, and so on. The
  172. default values supplied will work with most machines, with the possible
  173. exception of the com port. QWK'n'Dirty uses COM1: for the modem by
  174. default. If your modem is on COM2:, make sure to set it so in the
  175. configuration process.
  176.  
  177. You can reconfigure QWK'n'Dirty from the terminal screen by typing
  178. ALT-O.
  179.  
  180. You'll now be in terminal mode. Any ordinary key you type will be
  181. sent to the modem, and any incoming data from the modem will be
  182. sent to your screen. You can also use ALT commands from the terminal
  183. mode to access other QWK'n'Dirty commands. Here is a summary of
  184. the available commands:
  185.  
  186. ALT-D: This command is used to get to the menu for dialing other systems
  187. and reading QWK packets. For a full explanation see "The Dial/Read Menu",
  188. below